Nginx基础篇（2）- Nginx基本配置文件和变量详解

Nginx基本配置文件和变量详解

1. 基本配置文件

/etc/nginx/nginx.conf

# nginx运行的用户
user  nginx;
# nginx进程数，建议设置为等于CPU总核心数。
worker_processes  1;

# 全局错误日志文件名称和所在目录，错误日志记录级别[ debug | info | notice | warn | error | crit ]
error_log  /var/log/nginx/error.log warn;
# 进程文件nginx.pid所在目录
pid        /var/run/nginx.pid;

# 一个nginx进程打开的最多文件描述符数目，
# 理论值应该是最多打开文件数（系统的值ulimit -n）与nginx进程数相除，
# 但是nginx分配请求并不均匀，所以建议与ulimit -n的值保持一致。
# worker_rlimit_nofile 65535;

events {
    # 参考事件模型，use [ kqueue | rtsig | epoll | /dev/poll | select | poll ]; 
    # epoll模型是Linux 2.6以上版本内核中的高性能网络I/O模型，如果跑在FreeBSD上面，就用kqueue模型。
    # use epoll;

    # 单个进程最大连接数（最大连接数 = 连接数 * 进程数）
    worker_connections  1024;
    
    # multi_accept on;
}

# http服务器配置
http {
    # 引入http协议的Content-Type与扩展名对应关系的文件
    include       /etc/nginx/mime.types;
    # 默认文件类型
    default_type  application/octet-stream;
    
    # 指定日志格式
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';
    
    # HTTP服务器请求日志文件的名称和所在目录、日志记录级别
    access_log  /var/log/nginx/access.log  main;

    # 开启高效文件传输模式。
    # sendfile指令指定nginx是否调用sendfile函数来输出文件，对于普通应用设为on，
    # 如果用来进行下载等应用磁盘IO重负载应用，可设置为off，以平衡磁盘与网络I/O处理速度，降低系统的负载。
    # 注意：如果图片显示不正常把这个改成off。
    sendfile        on;
    # 防止网络阻塞
    # tcp_nopush    on;
    # tcp_nodelay   on;

    # 开启目录列表访问，合适下载服务器，默认关闭。
    # autoindex on; 
    
    # 开启限制IP连接数的时候需要使用
    # limit_zone crawler $binary_remote_addr 10m; 
    
    # 长连接超时时间，单位是秒
    keepalive_timeout  65;

    # gzip模块设置
    # 开启gzip压缩输出
    # gzip  on;
    # 最小压缩文件大小
    # gzip_min_length 1k; 
    # 压缩缓冲区
    # gzip_buffers 4 16k; 
    # 压缩版本（默认1.1，前端如果是squid2.5请使用1.0）
    # gzip_http_version 1.0; 
    # 压缩等级
    # gzip_comp_level 2; 
    # 压缩类型，默认就已经包含text/html，所以下面就不用再写了，写上去也不会有问题，但是会有一个warn。
    # gzip_types text/plain application/x-javascript text/css application/xml;
    # gzip_vary on;
        
     
    # FastCGI相关参数是为了改善网站的性能：减少资源占用，提高访问速度。
    # fastcgi_connect_timeout 300;
    # fastcgi_send_timeout 300;
    # fastcgi_read_timeout 300;
    # fastcgi_buffer_size 128k;
    # fastcgi_buffers 8 128k;
    # fastcgi_busy_buffers_size 128k;
    # fastcgi_temp_file_write_size 128k;

    # 允许客户端请求的最大单文件字节数。 
    # 如果请求大于指定的大小，则NGINX发回HTTP 413（Request Entity too large）错误。 
    # 如果服务器处理大文件上传，则该指令非常重要。
    # client_max_body_size 20m;
    # 用于请求主体的缓冲区大小。 
    # 如果主体超过缓冲区大小，则完整主体或其一部分将写入临时文件。 
    # 如果NGINX配置为使用文件而不是内存缓冲区，则该指令会被忽略。 
    # 默认情况下，该指令为32位系统设置一个8k缓冲区，为64位系统设置一个16k缓冲区。 
    # 该指令在NGINX配置的http，server和location区块使用。
    # client_body_buffer_size 128k;
    
    # upstream abc.com {
        # upstream的负载均衡，weight是权重，可以根据机器配置定义权重。weigth参数表示权值，权值越高被分配到的几率越大。
    #     server 192.168.10.121:80 weight=3;
    #     server 192.168.10.122:80 weight=2;
    #     server 192.168.10.123:80 weight=3;
    # }
    
    # 引入 '/etc/nginx/conf.d/' 目录下以 '.conf' 结尾的文件
    include /etc/nginx/conf.d/*.conf;
    
    # 虚拟主机的配置
    server {
        # 监听端口
        listen       80;
        # 域名，可以有多个，用空格隔开
        server_name  localhost;
        
        # 默认编码
        # charset utf-8; 
        
        # 日志格式设定
        # log_format access '$remote_addr - $remote_user [$time_local] "$request" '
        # '$status $body_bytes_sent "$http_referer" '
        # '"$http_user_agent" $http_x_forwarded_for';
        # 当前虚拟主机请求日志文件的名称和所在目录、日志记录级别
        # access_log  /var/log/nginx/host.access.log  main;

        location / {
            root   /usr/share/nginx/html;
            index  index.html index.htm;
        }
    
        #error_page  404              /404.html;
    
        # 将服务器错误页面重定向到静态页面 /50x.html
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   /usr/share/nginx/html;
        }
    
        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        # 将 PHP 脚本反向代理到监听 127.0.0.1:80 端口的Apache
        #location ~ \.php$ {
        #    proxy_pass   http://127.0.0.1;
        #}
    
        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        # 将 PHP 脚本反向代理到监听127.0.0.1:9000端口的FastCGI服务器
        #location ~ \.php$ {
        #    root           html;
        #    fastcgi_pass   127.0.0.1:9000;
        #    fastcgi_index  index.php;
        #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
        #    include        fastcgi_params;
        #}
    
        # 如果Apache的文档根目录与nginx的相同，拒绝访问.htaccess文件。
        #location ~ /\.ht {
        #    deny  all;
        #}
        
        # 图片缓存时间设置
        # location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ {
        #     expires 10d;
        # }
        
        # JS和CSS缓存时间设置
        # location ~ .*\.(js|css)?$ {
        #     expires 1h;
        # }
        
        # 对 "/" 启用反向代理
        # location / {
        #     proxy_pass http://127.0.0.1:88;
        #     proxy_redirect off;
        #     # 后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
        #     proxy_set_header X-Real-IP $remote_addr;
        #     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        #     # 以下是一些反向代理的配置，可选。
        #     proxy_set_header Host $host;
        #     # nginx跟后端服务器连接超时时间(代理连接超时)
        #     proxy_connect_timeout 90; 
        #     # 后端服务器数据回传时间(代理发送超时)
        #     proxy_send_timeout 90; 
        #     # 连接成功后，后端服务器响应时间(代理接收超时)
        #     proxy_read_timeout 90; 
        #     # 设置代理服务器（nginx）保存用户头信息的缓冲区大小
        #     proxy_buffer_size 4k; 
        #     # proxy_buffers缓冲区，网页平均在32k以下的设置
        #     proxy_buffers 4 32k; 
        #     # 高负荷下缓冲大小（proxy_buffers*2）
        #     proxy_busy_buffers_size 64k; 
        #     # 设定缓存文件夹大小，大于这个值，将从upstream服务器传
        #     proxy_temp_file_write_size 64k;
        # }
    }
}

2. Nginx变量

HTTP请求变量

• arg_参数名：例如，$arg_userid，可以引用到请求参数userid的值
• http_请求HEADER名：例如，$http_user_agent，可以引用到请求头信息User-Agent的值
• sent_http_返回HEADER名：在响应客户端可添加header头信息

内置变量

Nginx内置的变量，参考Nginx文档的Logging to syslog

自定义变量

服务器管理员自己定义的变量